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PREFACE 

This manual describes the OASIS system EXEC Language. It provides sufficiently 
detailed information necessary for the use of this language product in conjunction 
with the OASIS Operating System. 

This manual, named EXEC , like all OASIS documentation manuals, has the manual name 
and revision number (if applicable) in the lower, inside corner of each page of the 
body of the manual. In most chapters of the manual the last primary subject being 
discussed on a page will be identified in the lower outside corner of the page. 



Related Documentation 

The following publications provides additional information required in the use of 
the OASIS EXEC Language: 

OASIS System Reference Manual 
OASIS Text Editor Reference Manual 
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CHAPTER 1 

HITRODDCTIOM 

The OASIS EXEC Language is a process control language used to perform repetitive 
functions of the operating system. It can be compared to the JCL (Job Control 
Language) used on larger computers with the added capabilities of operator 
interaction and conditional execution. With EXEC programs an operator can perform 
tasks with less chance for error and with less Knowledge about the operating 
system. For example an EXEC program might be written to perform the daily disk 
backups. The operator would merely type the name of the EXEC program (it might 
even be executed automatically by another EXEC program) and the program would 
instruct him about which disks to load, where they can be found, what to do with 
them afterwards and perform the actual copying. 

The format of the EXEC command is: 

[SBC] fn [argl [arg2 ... [argl6]]] 

Where: 

fn Indicates the file name of an EXECutive procedure file. 

argl Indicates the first argument to be passed to the EXEC file. This argument 
may contain all ASCII characters except the space character. Only the 
first eight characters of the argument are actully passed to the EXEC 
file. 

arg2 Indicates the second argument to be passed to the EXEC file. 

argl6 Indicates the sixteenth argument to be passed to the EXEC file. 

The EXECutive procedure language processor executes an EXEC program as if an 
operator were entering programs to be executed from the console keyboard with the 
added ability to include conditional execution (decision processing; and iterative 
execution (repeat a process several times). With this ability you can write EXEC 
programs for procedures and routines that are. executed frequently or for executing 
a sequence of programs without operator attention. 

An EXECutive procedure file "is a sequential file, created by you with the system 
Editor or BUILD, containing CSI commands, EXEC instructions, data for a user 
program, data for another EXEC file, etc. 

The EXECutive procedure processor is an interpretive type processor in that the 
commands and data are not analyzed until they are executed by the processor. It is 
the EXEC command that invokes this processor. 

The arguments, argl through argl6, are optional but When specified they are 
truncated to the first eight characters and passed to the EXECutive procedure 
processor as command variables. An argument of a percent sign only (%) indicates 
that the argument is empty and is used when other arguments follow this argument. 

An EXEC file is a high level language program. Each record or line in the file is 
an instruction to the EXECutive procedure processor. An EXEC instruction is 
composed of various elements, discussed in subsequent sections. 

1.1 System Cancel during EXEC execution 

When the System Cancel key is entered from the console while an EXEC is in control 
the system will cancel the current command program and display the message: 

Cancel EXEC (Y/N)? 

You may respond with a Y or an M. AY response will cause the current EXEC to be 
canceled returning control to the Command String Interpreter. An N response will 
cause the current EXEC to continue execution. CThe return code will be set to 254 
in either case. ) 

1.2 The EXEC IPL and User Logon File 

An important feature of OASIS is the automatic execution of an EXEC program when 
the system is turned on or when an operator logs on to a new account. 

As explained in the chapter on "System Communications 11 in the OASIS System 
Reference Manual, the OASIS Operating System will execute an EXEC program named 
IPL. EXEC after the date and time is entered during initial system start-up. This 
EXEC program file may belong to the IPL account (or its synonym) or the system 
account and should contain the sequence of commands that you want executed when the 
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system is turned on. Normally these commands would include a LOGON to the account 
that contains the programs and data to be processed at the start of a day. When no 
IPL account exists the system will ask you to LOGON to an account. 

When an account is first logged on, the system will search that account's directory 
for an EXEC file with the file name equal to the account name. If a file is found 
it will be executed automatically, similar to the IPL. EXEC file during system 
start-up. For more information refer to the OASIS System Reference Manual chapters 
on "System Communication" and the "LOGON Command". 

1.3 The EXECn File 

An OASIS system disk contains a file named SYSTEM. EXEC1 . This file is only 
required by the EXEC language processor. Whenever an EXEC program executes another 
system or user program (including another EXEC program) the variables currently in 
use are saved in the EXEC1 file. 

If your system disk does not have an EXEC1 file you may create one, using the 
CREATE command. The EXEC1 file is a direct file with records of length 512 bytes 
each. Each record corresponds to one level of nesting. Up to 255 records may be 
specified when the file is created. 



i Multi-user OASIS note: The SYSTEM. EXEC1 file is named SYSTEM. EXEC1 , SYSTEM. EXEC2, j 
! etc., one for each user partition. j 

1.4 Variables and Constants 

A constant in an EXEC program is an unquoted string, not preceded by an ampersand 

character (&). If a constant contains only numeric characters then it is a numeric 

constant and has a numeric value. When a constant contains any non numeric 
characters then it is a string constant and has no numeric value. 

An EXEC programmer has three forms of variables available to him. These three 
forms include true variables (value can be changed during program execution by the 
program), command variables (value determined by the Command String Interpreter 
when the EXECutive procedure is invoked), and reserved variables (value determined 
by conditions outside of the program). 

True variables are identified by an ampersand followed by a alphabetic character, 
optionally followed by alphanumeric characters. The number of characters in a true 
variable name is technically unlimited, although the first eight characters 
(including the ampersand) must be unique. True variable names may not be the same 
as any of the EXEC keywords . The value of a true variable is determined by an 
assignment or READ instruction. Only sixteen true variables may be in use in any 
one EXEC program. Exceeding this limit causes a symbol overflow error. 

Command variables are identified by an ampersand followed by one or two digits. 
The value of command variables is determined by the Command String Interpreter and 
may not be changed during the execution of the EXEC program. The value of a 
specific command variable is determined by a one to one relation with the arguments 
in the EXEC command as defined in the syntax above. For instance &1 has the value 
of the first argument, &3 has the value of the third argument. There are only 
sixteen (16) command variables available to the programmer. The value of a command 
variable that has no matching argument (that is, fewer arguments were entered than 
the number of this command variable) is null or empty. 

Reserved variables are identified by their reserved names. The value of a reserved 
variable is determined differently for each reserved variable but may not be 
changed by the program itself. 

4INDEX Numeric value indicating the number of command variables. 

&LIHE Numeric value indicating the ATTACHed linesize of the console 
device. 

&HULL String value indicating an empty string (length =0). 

&PAGE Numeric value indicating the ATTACHed pagesize of the console 
device. 

4RETC0DE Numeric value indicating the system return code. This value is 
set by each program executed. 
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Examples: 

ABCD String constant 

TDEDWEFD String constant 

1245 Numeric constant 

34 Numeric constant 

124 Numeric constant 

&VALUE True variable 

&A True variable 

&4 Command variable 

&EDIT True variable 

&INDEX Reserved variable 

&RESERVED True variable (Only &RESERVE is used) 

&156 Invalid 

&RETCODE Reserved variable 

1.5 Labels 

An EXEC program may have labels to be used as comments or as a reference point for 
branching instructions. A label is identified by a negative sign (-) followed by 
an alphabetic character and optionally followed by alphanumeric characters. The 
length of a label name is limited to eight characters (including the negative 
sign) . 

Labels, when used, must start in column one of the line (no leading spaces other 
than the single space following a line number). 

Examples: 

-BEGIN 

-END 

-OPTION 1 

-BEGININPUT Causes an error 

1.6 Operators 

The EXEC language allows a minimal set of arithmetic and comparison operations to 
be performed. To perform an operation an operator must be used. There are three 
forms of operators: numeric operators, string operators, and comparison operators. 

A numeric operator indicates that arithmetic is to be performed between two 
variables or constants. The value of the variable or constant must be numeric in 
type. The valid numeric operators include: 

+ (addition) 
- (subtraction) 
* (multiplication) 
/ (division) 

The string operators available in the EXEC language include: 

i vertical bar - concatenate two variables or constants 

&CAT - concatenate two variables or constants 

&SUB - substring of following variable 

&TYP - type of following variable (Alpha or Numeric) 

&LIT - following characters are not to be tokenized 

&LEN - length of following variable 

Numeric and string operators are only allowed in the assignment instruction. 

Comparison operators are used between two variables or constants to indicate a 
relationship. Comparison operators are only allowed in the &IF, &WHILE, &UNTIL 
instructions. There are six comparison operators: 



EQ 


or 


= 


Equality 


NE 


or 


<> 


Not equal 


LT 


or 


< 


Less than 


GT 


or 


> 


Greater than 


LE 


or 


<= 


Less than or equal 


GE 


or 


>= 


Greater than or equal 
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Relations allowed in these instruction must be simple relations: 

<variable>!<coiistant> <operator> <variable>i<con3tant> 

In order to test a complex relationship the programmer must use the assignment 
instruction to create a single value for an expression or use multiple &IF 
instructions. 

Relational expressions may use two reserved keywords that may not be used 
elsewhere. These keywords are &* and &$. 

&• Keyword 

The &* keyword is a variable indicating " any of the command variables (&1 thru 
&16)". 

&$ Keyword 

The &$ keyword is a variable indicating " all of the command variables (&1 thru 
&16)". 

Examples i 

&IF &A GT 5 &G0T0 -LABEL 1 

&IF &INDEX EQ &G0T0 -ERROR 

&IF &RETCODE NE &TYPE Error in last program. 

&IF &VAR = &NULL &IF &A = &NULL &QUIT 

The following instruction tests all of the command variables to determine 
if any of them are equal to the literal PRINT. 

&IF &* = PRINT &OUTDEV = PRINTER 1 

The following instruction tests all of the command variables to determine 
if they are all unequal to a left parentheses. 

&IF &$ NE ( &SKIP 4 

1.7 Cements 

Comments may be inserted in an EXEC program by using the semi-colon (;) character. 
Comments may be placed on the same line as an instruction with the exception of the 
instructions?. &CONTROL, &TYPE, and assignment instruction. 

It is permissible to use spaces at the beginning of a line (except lines defining 
labels) or between tokens of an instruction to make the program easier to read but 
tabs may not be used. 
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EXEC INSTRUCTIONS 

The EXEC language has only a few instructions available to it but taken with the 
fact that all of the OASIS commands and user written programs may be executed from 
the EXEC environment the language is very powerful. 

The following instructions are presented in alphabetic sequence. 

It is important to keep in mind that the space character is a delimiting character 
and may not be used as part of a variable name or contents. 

2.1 Variable Assignment Instruction 

The assignment instruction allows you to change or set the value of a true 
variable. The format of the instruction is: 

[line #] [label] true-variable = expression 

Where : 

true- variable Indicates any valid true variable name as defined previously. 

expression Indicates any valid expression. Since this is the only instruction that 
allows an expression it will be defined here: 

<variable>!<const> [<numeric operator > <expression>] ... 

or 

<variable>|<const> [<string operator > <variable> ! <const>] 

The expression on the right side of the operator must match in type to the variable 
or constant on the left side of the operator. 

Any of the numeric or string operators may be used but they must be separated from 
the other elements by at least one space. 

Any arithemetic performed is in signed binary integers. The range of value for a 
numeric expression is -32768 to 32767. Expression exceeding this range will be 
converted to a value within the range by modulo arithmetic. (32770 is converted to 
3* -32770 is converted to +32766, etc.) All sub-expressions are computed, 
integerized and converted to modulo 32768 before remaining expressions are 
computed. This means that 1024 * 64 + 1 is equal to 1. (1024 • 64 = 65536, 65536 
modulo 32767 =0.) 



&CAT Keyword 

The &CAT keyword may be used in an assignment instruction to combine two string 
variables together. Optionally the vertical bar character (j) may be used. The 
format of an assignment instruction using the &CAT keyword is: 

<true var> = 4CAT <var> <var> 

or 

<true var> = <var> I <var> 

&LEN Keyword 

The &LEN keyword may be used in an assignment instruction to determine the length 
of the contents of another variable. The format of an assignment instruction using 
the &LEN keyword is: 

<true var> = &LEN <var> 

The <true var> will contain a numeric value indicating the length of the contents 
of <var>. The &LEN keyword must precede a variable name and only one variable name 
may be specified. 

&LIT Keyword 

The &LIT keyword may be used in an assignment instruction before a string to 
indicate that the string is not to be tokenized. This is especially useful when 
the string looks like a reserved variable name. The format of an assignment 
instruction using the &LIT keyword is: 
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<true var> s &LIT <string> 

&SUB Keyword 

The &SUB keyword may be used in an assignment instruction to access a portion of a 
variable or constant. The format of an assignment instruction using the &SUB. 
keyword is: 

<true var> s 4S0B <token> <1st char> [<last char>] 

When the &SUB is evaluated the token following is tokenized. The resulting string 
is then used - the characters between the <1st character> and the <last character> 
are extracted and assigned to the <true variable>. When <last character > is not 
specified the characters from <1st character > position through the end of the 
string are assigned to the <true variable>„ 

&TIP Keyword 

The &TYP keyword is used in an assignment instruction to determine the variable, 
type of a variable. The format of an assignment instruction using the &TYP keyword 
is: 

<true var> = &TIP <var> 

The <var> is evaluated and the variable type (A or N) is assigned to the <true 
variable>. 



Examples: 



&A = ABCDEFGH 
&ALPHA = &A ! EFGH 

&A1 = &SUB &ALPHA 3 4 

&A2 = &LEN &ALPHA 

&X = &TYP &ALPHA , 

&BETA = &KAPPA + 123 / &DELTA 



&A receives « ABCDEFGH* 

&ALPHA receives ' ABCDEFGHEFGH » 

which is tokenized to ' ABCDEFGH » 

&A1 receives 'CD' 

&A2 receives an 8 

&X receives T A' (alpha) 



2.2 BEGSTACK Instruction 



The BEGSTACK instruction allows you to to create lines of data to be used by 
programs executed from the EXEC program. The format of the instruction is: 



Where : 

label 

LIFO 

FIFO 



[line #] [label] &BEGSTACK [LIFO.'FIFO] 



Indicates any valid label. 

Indicates that the lines of data following the 
placed on the stack in a Last-In-First-Out manner. 



instruction are to be 



Indicates that the lines of data following the instruction are to be 
placed on the stack in a First-In-First-Out manner. This is the default 
option. 

A stack may be created using both LIFO and FIFO elements by using multiple 
BEGSTACK or STACK instructions. 

The BEGSTACK instruction is followed by the lines of text or data that is to be 
placed on the stack. The data is placed on the stack with no analysis (that is, if 
a variable name is specified then the variable name is placed on the stack and not 
the contents of it) . The data is terminated with the &END instruction. 

The information that is placed in the stack by this instruction (or the &STACK 
instruction discussed later) is accessible by the next program that is executed by 
this EXEC program. Programs executed from the EXEC environment that require 
console keyboard input will receive any data in the stack instead of the keyboard. 

After the information stored in the stack has been retrieved by a program, future 
requests for console input will receive data from the keyboard directly. Any 
information not retrieved from the stack will be lost when the program is 
terminated and control returns to the EXEC program. 



BEGSTACK 
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2.3 BEGTIPE Instruction 



The BEGTYPE instruction allows you to display information on 
The format of the instruction is: 

[line #] [label] &BE6TTPE 



the console display. 



The BEGTYPE instruction is followed by the lines of information that are to be 
displayed on the console display. Similar to the BEGSTACK instruction, the data is 
not analyzed before display and the information is terminated with the &END 
instruction. 



Each line of information following the BEGTYPE 
separate line of the console, one after the other. 

2.4 CONTROL Instruction 



instruction is displayed on a 



The CONTROL instruction allows you the ability to turn on or off the display of any 
commands executed from the EXEC program. The format of the instruction is: 



Where : 
ON 

OFF- 
TRACE 

STACK 
NOSTACK 



[line #] [label] &COHTROL OH ! OFF S TRACE ! STACK ! NOSTACK 



Indicates that CSI commands executed from the EXEC program are to be 
displayed on the console. This is the condition that exists when the EXEC 
program is first entered. 

Indicates that CSI commands executed from the EXEC program are to be 
executed "silently", that is, the display of the command itself is to be 
inhibited. 

Indicates that all CSI commands and EXEC instructions are to be displayed 
on the console after tokenization, before execution. The line number of 
EXEC instruction is displayed surrounded with angle brackes <> followed by 
the result of the execution of the instruction. 

Indicates that information retrieved from the stack is to be displayed on 
the console, gust as if it had come from the keyboard. This is the 
default condition when the EXEC program is first entered. 

Indicates that information retrieved from the stack is not to be displayed 
on the console. In addition, when information is in the stack all output 
to the console device is suppressed. 



2.5 CRT Instruction 

The CRT instruction allows you to position the cursor on the console output device 
to any position or to perform screen control functions* The format of the 
instruction is: 

[line #] [label] &CRT <column# variable> <line# variable> 

or 



Where : 
column* 



line* 



[line #] [label] &CRT <varlable> |<constant> 



variable Contains the value of the column number that you wish the cursor 
positioned to. This must be a numeric value. 

variable Contains the value of the line number that you wish the cursor 
positioned to. This must be a numeric value. Caution: addressing a line 
greater than the screen actually allows produces unpredictable results. 



variable Contains the screen control function to be performed. The specific 
functions allowed vary from terminal to terminal and are controlled by the 
class code that the console was ATTACHed as. 

constant Is the literal specifying the screen control function to be performed. 
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The various screen control functions allowed by the system include the following: 

HOME Move cursor to upper left corner 

CLEAR Clear screen 

EOS Erase to end of screen 

EOL Erase to end of line 

UP Move cursor up one line 

DOWN Move cursor down one line 

LEFT Move cursor one position to the left 

RIGHT Move cursor one position to the right 

BELL Sound console bell/buzzer 

IL Insert blank line 

DL Delete line 

IC Insert blank character 

DC Delete character 

EU Erase screen, unprotected 

PON Following charcters are to be screen protected 

POFF Following charactes are not screen protected 

KON Keyboard unlock 

KOFF Keyboard lock 

FON Format on 

FOFF Format off 

BON Blink mode one 

BOFF Blink mode off 

RVON Reverse vidio on 

RVOFF Reverse vidio off 

ULON Underline on 

ULOFF Underline off 

Examples : 

&A s 5 
&CRT 15 &A 
&CRT 3 4 
&CRT &A &A 
&CRT CLEAR 

2.6 CSI couand 



Position to line 5, column 15 

Position to line 4, column' 3 

Position to line 5, column 5 
Clear screen 



All OASIS commands and user written programs may be executed from an EXEC program. 
The format of the CSI command is : 

[line #] [label] <cownand-text> 

The <command-text> must specify any parameters or options desired. Before the text 
specifying the command is passed to the Command String Interpreter it is analyzed 
for variables, and substitutions are made as applicable. 

No restriction is placed on the programs that may be executed in this manner. In 
fact the program may specify another EXEC program to be executed. This is called 
nesting. The maximum level of "nesting" of EXEC program calls is determined by the 
number of records that were created for the SYSTEM. EXEC1 file. This maximum, as 
stated earlier, is 255. When an EXEC program is executed in this manner the 
current program will be suspended, control is transferred to the specified EXEC 
program, and, upon termination of that program, control returns to the "calling" 
program. The current &CONTROL status is retained when the called EXEC is executed. 
If that EXEC changes the &CONTROL the change will be in effect until changed again 

Examples: 

LIST FILE DATA S (PRINT 
BASIC &1 

FILELIST * &A &B ( &C 
FILELIST &A (FN 

It is best to use the normal, complete spelling of command names in an EXEC due to 
the reduction in search time. 

2.7 BID Instruction 

The END instruction provides a means of terminating the data list following the 
BEGTYPE or BEGSTACK instruction. The format of the instruction is: 

[line #] [label] &EHD 

The END instruction must appear on a line by itself and must be used to terminate 
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the data lines of a BEGSTACK or BEGTYPE. 

2.8 ERROR Instruction 

The ERROR instruction allows you to specify an instruction to be executed in the 
event that an error is detected by a CSI command. The format of the instruction 
is: 



[line #] [label] &ERROR <instruction> 



Where : 



instruction Indicates any valid EXEC instruction described in this manual. 

Omitting <instruction> indicates that the system return code will not 

cause any EXEC instruction to be executed when the return code is 
non-zero. 

When the ERROR instruction is executed the <instruction>, when specified, is saved. 
After any CSI command is executed by the EXEC the system return code is tested and, 
if non-zero, the saved instruction is automatically executed. This has the same 
result as if the program had an IF instruction following each CSI command, that 
tested the &RETCODE reserved variable for a non-zero condition. The ERROR 
instruction has the added versatility of changing the instruction to be executed 
when an error is detected for all subsequent CSI commands. 

Examples: 

&ERROR &G0T0 -LABEL 

&ERROR &IF &RETCODE GT 200 &G0T0 -LABEL 

&ERR0R 

&ERR0R &TYPE Error &RETC0DE detected — Program aborted! 

2.9 ESC Instruction 

The ESC instruction allows you to perform the actions of the system control keys 
(those that have a lead in of ESC) from within an EXEC program. The format of the 
instruction is: 

[line #] [label] &ESC <function-character> [OH! OFF] 

Where: 

function-character Indicates the literal character or variable that contains the 
character. to be given to the operating system as if it had been typed from 
the console keyboard following an escape character. 

ON i OFF Indicates that the function is to be set to the specified status 
irregardless of its current status. (&ESC P OFF will force the printer 
echo function to the off status.) 

The command operates just as if the function were performed from the keyboard. 

This means that execution of the instruction &ESC P causes the status of the 

printer echo switch to be changed from OFF to ON or ON to OFF, depending upon the 
current status. 

2.10 GOTO Instruction 

The GOTO instruction allows you to branch to another portion of the EXEC program. 
The format of the instruction is: 

[line #] [label] &GOTO label 

Where: 

label Indicates a valid label in the program. 

Examples: 

&G0T0 -BEGIN 

-L00P1 &G0T0 -RESTART 

&G0T0 -P0INT1 

&G0T0 -LABEL10 
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2.11 IF Instruction 

The IF instruction allows you to test variables and, depending upon the results of 
the test, execute an instruction. The format of the instruction is: 

[line #] [label] &IF <relation> <instruction> 

Where: 

relation Indicates a simple relation as described previously. 

instruction Indicates any of the EXEC instruction described in this section. 

The IF instruction evaluates the relation and, if the relation is true, executes 
the instruction specified. If the relation is false the instruction on the 
following line is executed and the instruction following the relation is ignored. 

2.12 QUIT Instruction 

The QUIT instruction allows you to specify the termination of the logic in an EXEC 
program. The format of the instruction is: 



[line #] [label] &QOIT [value] 



Where : 



value Indicates the optional value that the return code is to be set to. If 
this value is not specified the return code is set to zero. This value 
may be a numeric literal or any variable with numeric contents. 

The QUIT instruction unconditionally terminates execution of the current EXEC 
program. If the EXEC program was invoked from a keyboard command then control will 
return to the Command String Interpreter. If the EXEC program was invoked from 
another EXEC then control will return to the instruction following the one invoking 
this program in the calling program. 

2.13 READ Instruction 

The READ instruction allows you to request input from the keyboard during the 
execution of an EXEC program. The format of the instruction is: 

[line #] [label] AHEAD [true- variable] ... 

When the READ instruction is encountered execution of the program is interrupted. 
The EXEC prompt character ( : ) is displayed on the console at the current cursor 
position and data is accepted from the keyboard. If any data is currently in the 
stack, whether loaded by this EXEC or a previous EXEC "calling" this program, the 
required information will be retrieved from the stack. Each element of the data 
entered is truncated to eight characters and assigned to the list of variables in a 
one to one relationship. When more variables are specified than data entered the 
"extra" variables are set to null or empty. When more data is entered than 
variables specified the "extra" data is ignored. The elements of the data entered 
must be separated by at least one space and terminated by a carriage return. 

When the READ instruction doesn't specify a variable for the input to be assigned 
to, the data entered will be executed as if were part of the EXEC program. 

Examples: 

&READ &ALPHA &BETA &CHARLIE &DELTA 

&READ &NEVADA 

&READ &A &B 
&READ 

2.14 REPEAT Instruction 

The REPEAT instruction, used in conjunction with the UNTIL or WHILE instruction, 
provides a method of loop control. The format of the instruction is: 

[line #] [label] AREPEAT 

When the REPEAT instruction is executed control of the program is transferred to 
the first UNTIL or WHILE instruction that precedes the REPEAT instruction. 

For examples of the REPEAT instruction see the UNTIL and WHILE instructions. 
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2.15 SKIP Instruction 

The SKIP instruction allows you to "jump relative" to the current instruction. 
This instruction is usually used as the instruction in an IF instruction or the 
instruction following the IF instruction. The format of the instruction is: 

[line #] [label] &SEEP count 

of lines, relative to the current instruction, that 



Where : 








count 


Indicates 
are to be 


the number 
skipped. 


Examples 


&SKIP 1 
&SKIP 4 
&SKIP -2 







2.16 SPACE Instruction 

The SPACE instruction allows you to display multiple carriage return, line feeds on 
the console. The format of the instruction is: 

[line #] [label] &SP ACE [count] 

Where : 

count Indicates the number of lines that are to be advanced on the console. If 
count is omitted one line will be advanced. 

Examples: 

&SPACE 5 
&SPACE &A 
&SPACE 

2.17 STACK Instruction 

The STACK instruction allows you to place one line of analyzed data on the stack. 
The format of the instruction is: 

[line #] [label] &STACK [FIFOiLIFO] data 

Where : 

FIFO Is as described for BEGSTACK. 

LIFO Is as described for BEGSTACK. 

data Indicates the information to be placed on the stack. This data may 
include constants or variables. Each variable encountered by the EXEC 
processor during analysis of the data will be replaced by its current 
value. 



Examples: 

&STACK HELLO 

&STACK LIFO &A &BETA HI 

&STACK 

2.18 TYPE Instruction 

The TYPE instruction allows you to display one line of analyzed data on the 
console. The format of the instruction is: 

[line #] [label] &TYPE data ... [\] 

Where : 

data Is as described for the STACK instruction. 

\ Indicates that the data is to be displayed with no automatic carriage 
return, line feed following. This option is usually used when the 
displayed text is the prompting message for a READ instruction. 
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Examples: 

&TYPE This is a message. 

&TYPE This is another message &A 

&TYPE And so is this 

&TYPE &ALPHA &BETA HELLO &CHARLIE &ETC 

2.19 OHTEL Instruction 

The UNTIL instruction provides a method for conditional loop control • The format 
of the instruction is; 

[line #1 [label] &UNTIL <relation> 

Where : 

relation Is the same as for the IF instruction. 

When the UNTIL instruction is executed the <relation> is analyzed and. if false, 
the intructions following are executed. When the relation is true, the instruction 
following the next REPEAT instruction is executed. 

It is easiest to remember the function of the UNTIL instruction if you think of it 
as: 'execute following instruction until <relation> is true'.. 



Example : 



&A = 123 

&UNTIL &A LT 100 

&A = &A - 1 

&TYPE &A 

&REPEAT 

&TYPE Done 



The above example will execute the decrement and type instructions twenty-four 
times, until the variable &A is less than one hundred, at which point the literal 
'Done' will be displayed on the screen. 

2.20 WAIT Instruction 

The WAIT instruction causes the program to pause until the operator types a key. 
The format of this instruction is: 

[line #] [label] WAIT 

When this instruction is executed it invokes the same process that the system 
programs use when displaying information to the screen. When encountered by the 
EXEC processor an up arrow character ( ) is displayed at the bottom left corner of 
the screen and processing is suspended until the operator enters a key. The 
function of this instruction may be suppressed if the Console Screen-wait key has 
been used to disable the screen wait function (see System Control Keys in the 
System Reference Manual) . 

2.21 WHILE Instruction 

The WHILE instruction provides an alternate means of loop control. The format of 
the instruction is: 

[line #] [label] &WHILE <relation> 

Where : 

relation Is the same as for the IF instruction. 

When the WHILE instruction is executed the <relation> is analyzed f and, if true, 
the following instructions are executed. When the <relation> is false control 
transfers to the instruction immediately following the next REPEAT instruction. 

It is easiest to understand the function of the WHILE instruction if you think of 
it as: 'execute following instructions while the <relation> is true'. 

Example: 
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&WHILE &RETCODE = 
&TYPE Command to execute 
&READ 
&REPEAT 



The above example will ask the operator for a command name to execute and execute 
that command as long as the system return code is zero. Notice that the READ 
instruction is not followed by a variable name. In this situation the data read 
from the console (or stack, if present), is treated as an EXEC instruction, and 
executed. 

2.22 Tokenizing 

The EXEC language processor analyzes each instruction line in a right to left 
manner, reducing each element to the most elementary form. This process of 
reduction is called tokenizing. An element is tokenized until a space is 
encountered or column one is encountered. For example, if &A1 contains a 25 f &B2 
contains 1, and &C contains 2, the element &A&B&C is tokenized in the following 
manner: 



&A&B&C 
&A&B2 
&A1 
25 



&C is replaced with 2 
&B2 is replaced with 1 
&A1 is replaced with 25 



The end result of a tokenized element is always truncated to eight characters. 
This process is performed on all elements of an instruction. The following 
instructions will execute the BACKUP command: 

0010 &A = BACKUP 
0020 &A 

The following example will also execute the BACKUP command: 

0010 &A1 = BACKUP 
0020 &B = 1 
0030 &A&B 

The &A&B element is. PAGE 6 

2.23 Tokenizing 

The EXEC language processor analyzes each instruction line in a right to left 
manner, reducing each element to the most elementary form. This process of 
reduction is called 
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APPEHDK A 

EXEC EXAMPLES 

A«1 Example 1 - Abbreviate BASIC Program 

0010 &BEGSTACK 

0020 CHANGE / PRINT/ PRI/* * 

0030 TOP 

0040 CHANGE /GOTO/GO/* « 

0050 TOP 

0060 CHANGE /GOSUB/GOS/* * 

0070 TOP 

0080 CHANGE / = /=/* * 

0090 TOP 

0100 CHANGE / //* * 

0110 TOP 

0120 PAGE 

0130 &END 

0140 EDIT &1 &2 &3 

0150 &QUIT 

>EXEC EXAMPLE1 PR0GRAM1 BASIC A 

The above example will perform an edit of the BASIC program "PROGRAM .BASIC: A", 
changing all occurrences of PRINT to PRI, all occurances of GOTO to GO, etc. After 
the five global changes have been made to the file the first page is displayed. At 
this time the Edit program will have exhausted the stack and further input will 
come from the keyboard. 

A.2 Example 2 - IPL.EXEC 

0010 &C0NTR0L OFF 

0020 -AGAIN 

0030 RUN MAINPROG. BASIC :S 

0040 &G0T0 -AGAIN 

The above example is a typical system start EXEC program that executes a BASIC 
application program until the system cancel key is used or the system is turned 
off. This type of a program will "isolate" the user from using the OASIS commands. 
Alternately this program might have displayed a list of options for the user such 
as making backups of the application diskettes, etc. 

A.3 Example 3 - SELECTED. EXEC 

>FILELIST * BASIC (EXEC 

>EXEC SELECTED LIST (PRINT 

This example will create an EXEC program containing command variables and file 
descriptions of all of the BASIC programs on the attached diskettes (see the 
FILELIST command) . When the EXEC program is executed with the above specification 
all of these BASIC program files will be listed on the printer. "LIST" replaces 
all &1. "(" replaces all &2, "PRINT" replaces all &3. Similarly a group of files 
could be copied, erased, renamed, etc. The EXEC program created from the FILELIST 
command is normally edited to remove or add file descriptions or EXEC instructions. 
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A.4 Example 4 - ASM. EXEC 

The following example is a listing of the ASM. EXEC, distributed with the OASIS 
operating system. Its purpose is to assemble and link an assembly language source 
program using the MACHO and LINK commands. 

>LIST ASM. EXEC s S 

0010 j ASM procedure 

0020 ; 

0030 I Copyright (C) 1979 by 

0040 ; Timothy S. Williams 

0050 J 

0060 : 

0070 4IF 4INDEX EQ &G0T0 -N0FILE 

0080 4IF 4INDEX EQ 1 4IF 41 EQ HELP &G0T0 -HELP 

0090 40PT s 

0100 4IF 41 EQ ( 4G0T0 -NOFILE 

0110 4FN = 41 

0120 4IF 4INDEX EQ 1 4G0T0 -ASM 

0130 4IF 42 EQ ( 4G0T0 -0PTASM 

0140 4FT =42 

0150 4IF 4INDEX EQ 2 4G0T0 -ASM 

0160 4IF 43 EQ ( 4G0T0 -0PTASM 

0170 4FD = 43 

0180 4IF 4INDEX EQ 3 4G0T0 -ASM 

0190 -OPTASM 

0200 4CT = 

0210 -L00P1 

0220 4CT = 4CT + 1 

0230 4IF 4CT GT 4INDEX 4G0T0 -ASM 

0240 4IF 44CT NE ( 4G0T0 -L00P1 

0250 -L00P2 

0260 4CT = 4CT + 1 

0270 4IF 4CT GT 4INDEX 4G0T0 -ASM 

0280 4IF 44CT EQ / 4G0T0 -ASM 

0290 40PT r 40PT + 1 

0300 40PT40PT = 44CT 

0310 4G0T0 -L00P2 

0320 -ASM 

0330 4PAREN = 

0340 4IF 40PT NE 4PAREN = ( 

0350 MACRO 4FN 4FT 4FD 4PAREN 40PT1 40PT2 40PT3 40PT4 40PT5 40PT6 40PT7 40PT8 

036 4IF 4RETC0DE NE 4QUIT 4RETC0DE 

0370 4IF 4* EQ N00BJ 4QUIT 

0380 40PT = 

0390 4CT = 1 

0400 -L00P3 

0410 4CT = 4CT + 1 

0420 4IF 4CT GT 4INDEX 4G0T0 -LINK 

0430 4IF 44CT NE / 4G0T0 -L00P3 ' 

0440 -L00P4 

0450 4CT = 4CT + 1 

0460 4IF 4CT GT 4INDEX 4G0T0 -LINK 

0470 40PT = &0PT + 1 

0480 40PT40PT = 44CT 

0490 4G0T0 -L00P4 

0500 -LINK 

0510 4IF 40PT EQ 1 4IF 40PT1 EQ NOLINK 4QUIT 

0520 4IF 40PT LT 2 4G0T0 -NOREN 

0530 4IF 40PT1 NE RENAME 4G0T0 -NOREN 

0540 4FN = 40PT2 

0550 ERASE 4FN OBJECT * ( NOQUERY 

0560 RENAME 41 OBJECT « 4FN = = ( NOQUERY 

0570 4CT = 

0580 4CT2 =2 

0590 40PT = 40PT - 2 

0600 -L00P5 

0610 4CT = 4CT + 1 

0620 4CT2 = 4CT2 + 1 

0630 4IF 4CT GT 40PT 4G0T0 -NOREN 

0640 40PT4CT =40PT4CT2 

0650 4G0T0 -L00P5 

0660 -NOREN 

0670 4PAREN = 

0680 4IF 40PT NE 4PAREN = ( 
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0690 &CT = &0PT 

0700 -L00P6 

0710 &CT = &CT + 1 

0720 &IF &CT GT 9 &G0T0 -LINKIT 

0730 &OPT&CT = 

0740 &G0T0 -L00P6 

0750 -LINKIT 

0700 LINK &FN &PAREN &OPT1 &OPT2 &0PT3 &0PT4 &OPT5 &0PT6 &0PT7 &OPT8 &0PT9 

0770 &IF &RETC0DE NE &QUIT &RETC0DE 

0780 ERASE &FN OBJECT * ( NOQUERY 

0790 &QUIT 

0800 -NOFILE 

0810 &BEGTYPE 

0820 Filename missing! 

O83O 

0840 Use: ASM HELP to display syntax. 

0850 &END 

0860 &QUIT 255 

0870 -HELP 

0860 &BEGTYPE 

0890 Function: To assemble and link a source program. 

0900 

0910 Syntax: ASM fn [ ft [ fd ]] [ ( macro options [ / link options ] ) ] 

0920 &END 

0930 &QUIT 
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A. 5 Example 5 - CLEAHUP.EXEC 



0010 

0020 

0030 

0040 

0050 

0060 

0070 

0080 

0090 

0100 

0110 

0120 

0130 

0140 

0150 

0160 

0170 

0180 

0190 

0200 

0210 

0220 

0230 

0240 

0250 

0260 

0270 

0280 

0290 

0300 

0310 

0320 

0330 

0340 

0350 

0360 

0370 

0380 

0390 

0400 

0410 

0420 

0430 

0440 

0450 

0460 

0470 

0480 

0490 

0500 

0510 

0520 

0530 

0540 

0550 

0560 

0570 

0580 

0590 

0600 

0610 

0620 

06 

06 

0650 

0660 

0670 

0680 

0690 

0700 

0710 

0720 

0730 

0740 



&CONTROL OFF 

: Default drive is * (all) 

JyDRV — * 

&IF &INDEX EQ &G0T0 -DEFAULT 

&IF &INDEX EQ 1 &IF &1 EQ HELP &GOTO -HELP 

&IF &INDEX GT 1 &IF &1 EQ HELP &GOTO -ERROR 

&IF &1 ME ( &DRV s &1 

&IF &1 NE ( &IF &INDEX EQ 1 &GOTO -DEFAULT 

&IDX = 

&WHILE &IDX LT &INDEX 

&IDX = &IDX + 1 

&IF &&IDX EQ ( &GOTO -OPTIONS 

&REPEAT 
-ERROR 

&TYPE Syntax error 

&QUIT 

t 

; One or more options specified 

-OPTIONS 

&WHILE &IDX LT &INDEX 
&IDX = &IDX + 1 
&IF &OPTION EQ 1 &G0T0 -NAMES 
&IF &OPTION EQ 2 &G0T0 -TYPES 
&IF &&IDX EQ NAME &G0T0 -NAME 
&IF &&IDX EQ TYPE &GOTO -TYPE 
&GOTO -CONTINU 

t 

; Option NAME specified 

-NAME 

&OPTION = 1 
&IDX = &IDX + 1 

Still in option NAME 



-NAMES 



&IF &IDX GT &INDEX &QUIT 
&IF &&IDX EQ TYPE &GOTO -TYPE 
ERASE &&IDX * &DRV (NOQUERY) : 
&GOTO -CONTINU 



Erase files with NAME 



Option TYPE specified 

-TYPE 

&OPTION = 2 
&IDX = &IDX + 1 

Still in option TYPE 

-TYPES 



-CONTINU 



&IF &IDX GT &INDEX &QUIT 

&IF &&IDX EQ NAME &G0T0 -NAME 

ERASE * &&IDX &DRV (NOQUERY) ; Erase files with TYPE 



&REPEAT 
&QUIT 

; Erase only BACKUP files 
-DEFAULT 

ERASE * BACKUP &DRV (NOQUERY) 

&QUIT 
-HELP 
&BEGTYPE 

Function: Erase groups of files from disk(s) 

Syntax: CLEANUP [fd] [(options[)]] 

Where : 

fd - Drive to be cleaned (default = all) 

Options: 

NAME Following arguments are names to be erased 
multiple file names may be specified. 
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0750 TYPE Following arguments are types to be erased 

0760 multiple file types may -be specified. 

0770 

0780 When no options are specified all BACKUP files will 

0790 be erased from the specified disk(s). 

0800 &END 

0810 &QUIT 
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Keyword Function 



&BEGSTACK Stacks the lines following in the console input buffer without tokenizing 

them. 
&BEGTYPE Types the lines following on the console output device without tokenizing 

them. 
&CAT Indicates a concatenation of two variables or tokens without the result 

being tokenized. 
&CONTROL Sets switch indicating whether commands executed are displayed on the 

console device. 
&CRT Positions cursor on console device or perform screen function. 
&END Terminates the data following a &BEGSTACK or &BEGTYPE. 
&ERROR Designate instruction to be executed in event of error. 
&ESC Generates System Control Key sequences. 
&GOTO Unconditionally branches to a label in the EXEC file. 
&IF Tests variables and/ or arguments. 

&INDEX Variable indicating the number of arguments passed to the EXEC processor. 
&LEN Computes value of the length of the variable following. 
&LINE Variable containing the value of the console line length. 
&LIT Causes the following character to not be evaluated as a token. 

Characters are truncated to eight. 
&NULL Variable containing no characters. ' > 

&PAGE Variable containing the value of the console page length. 
&QUIT Transfers control out of the current EXEC file. 
&READ Accepts input from the console input device. The data read is assigned 

to the interns.1 vsriabl@s 
&REPEAT Execute previous loop again (used in conjunction with UNTIL or WHILE). 
&RETCODE Variable indicating the return code passed to the EXEC processor. 
&SKIP Unconditionally branches to a line relative to this statement. 
&SPACE Types blank lines on the console output device. 
&STACK Stacks a line in the console input buffer. Line is tokenized. 
&SUB Indicates a sub-string of a variable or token. 

&TYP Causes the variable type of the variable following to be, determined. 
&TYPE Prints a line at the console output device. Line is tokenized. 
&UNTIL Execute loop until, condition is true. 
&WAIT Causes program to pause until operator responds. 
&WHILE Execute loop while condition is true. 

&* Indicates a test of any tokens matching specified comparison. 
&$ Indicates a test of all tokens matching specified comparison. 
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